home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 25 / Cream of the Crop 25.iso / disk / attmn042.zip / ENGLISH.TXT < prev    next >
Text File  |  1997-05-10  |  15KB  |  322 lines
  1. -----------------------[Attribute Manager V.0.42 beta]-------------------------
  2.  
  3. -------------[(c) 1997 Alessandro Cantatore * Team OS/2 Italy]--------------
  4.  
  5. This program is freeware and it is beta code. Anyway it should be safe and
  6. not able to cause any loss of data. You can freely use it until July the
  7. 31th 1997 or as soon as a new version will be released.
  8.  
  9. As a standard disclaimer:
  10.  
  11. Under no circumstances the author is liable for any loss or damage.
  12. The use of the program implies acceptance of the conditions stated above.
  13.  
  14. ----------------------------------------------------------------------------
  15.  
  16. What is new with this release
  17. =============================
  18.  
  19. - The main window is resizeable and its size/position is stored in the
  20.   program INI file.
  21. - Read/edit both ordinary and extended attributes.
  22. - File/directory name with wild chars accepted as arguments.
  23. - A different INI file can be specified as argument.
  24. - It is possible either to show just the attributes of the current file or
  25.   show both attributes and the drive/path/file selection window.
  26. - A small toolbar with contextual help for the main functions.
  27. - Contextual menu in the various part of the main window.
  28. - A lot of options can be specified by a preferences notebook.
  29. - A new directory selection listbox
  30.  
  31.     
  32. Introduction
  33. ============
  34. The program allows to easily add, edit or delete the .SUBJECT, .COMMENTS and
  35. .KEYPHRASES extended attributes of your files.
  36. I have a lot of archived files I downloaded from the internet and often cannot
  37. remember their content or cannot find a particular file. Comment manager
  38. allows to add a small description (it can be as long as about 32 KB in this
  39. release) and some "Key Phrases" you can use when searching files.
  40. Even if the "Find" button is not yet operative in this release, the OS/2
  41. built-in Find utility allows file search based on the content of the
  42. "Key Phrases" extended attribute.
  43. Suppose you run a BBS and have archives of various kind of applications for
  44. different operating system, you could use various key phrases describing for
  45. example:
  46. -1) the author of the application
  47. -2) the operating system it is designed for
  48. -3) kind of application (file manager, game, etc.)
  49. -4) your evaluation (good application, useful, etc)
  50. -5) anything else
  51. This way, through the object find utility, you could automatically create
  52. folders containing all your "OS/2 text mode file managers", or all
  53. applications of your favourite software author and so on...
  54.  
  55.  
  56. Installation
  57. ============
  58. Just put it where you like and run it. It doesn't need any runtime library
  59. (i.e. DLL files) other than the operating system DLLs and won't mess with
  60. your INI files!
  61. All the informations needed by the program will be stored in its own INI
  62. file (ATTMAN.INI). Nothing will be added to OS2.INI or OS2SYS.INI.
  63. If you want to use a different INI file, you can pass its name as argument
  64. using the "P" option. The option is case insensitive and can be introduced
  65. either by "/" or by "-". So if you want to store your program preferences
  66. in "D:\PROGRAMS\MYINIFILE.INI" and open the program with the attributes
  67. of "C:\OS2\BITMAPS\*.GIF" you must type:
  68. ATTMAN -pD:\PROGRAMS\MYINIFILE.INI C:\OS2\BITMAPS\*.GIF
  69. The arguments cah have any order: the profile name can be specified either
  70. before or after the file name.
  71.  
  72.  
  73. Starting the program
  74. ====================
  75. You can start it from the command line, double click on its icon, or
  76. just drag a file/directory on its icon.
  77. In future I could add as option the chance to start it by the contetextual
  78. menu of any file object and will make the title bar accept operations
  79. of drag & drop in order to display the attributes of a different file.
  80.  
  81.  
  82. Help
  83. ====
  84. At the moment there is no on line help. To tell the truth there are
  85. still a lot of not yet implemented features so do not wonder if some
  86. menu option or button doesn't work.
  87. If you click with your mouse button 2 on a toolbar button you'll get
  88. some explanation about that button.
  89. Import, Report and Find still do not work.
  90.  
  91.  
  92. How it works
  93. ============
  94. It is like a file dialog box: just select a file and edit the attributes.
  95. If you have changed some attribute and select a new file or directory
  96. a dialog box will ask you if you want to save or discard what you modified.
  97. Click on the Save button to avoid that.
  98. If you chosed to work with the Extended selection option (see "Preferences")
  99. you can select one or more files in the same way you do that with other
  100. WPS objects:
  101.  - swiping the mouse pointer on the "File:" list box while pressing down MB1
  102.    (mouse button one)
  103.  - clicking with MB1 while keeping the "Ctrl" key pressed down for selecting
  104.    not-contiguous files
  105.  - clicking with MB1 while keeping the "Shift" key pressed down for selecting
  106.    all files betwen the previous selection and the current selection
  107. The file specifics and attributes showed concern the topmost selected file.
  108. If you want to set the same attribute for all selected files you must click
  109. on the "Save" button in the main window. A dialog box will then be displayed
  110. to allow you to choose which attributes to set for all the selcted files.
  111. For instance if the selected files have different "comments" and you want them
  112. to share the same "key phrases" without affecting "comments" or any other
  113. attribute, you must select only the "Key phrases" check box in the "Multiple
  114. File Save" dialog.
  115. The first button on the left allows to show/hide (browse/nobrowse mode) the
  116. drive/path/file selection window. For the same purpose you can use the menu
  117. by clicking with mouse button2 anywhere in the window and selecting:
  118. File->Select->Browse.
  119.  
  120.  
  121. Preferences
  122. ===========
  123. To open the preferences notebook select from the menu:
  124. Options->General Preferences.
  125.  
  126. [Common buttons]
  127.  
  128. - Undo:              It reverts the various buttons to their previous
  129.                      state.
  130.  
  131. - Default:           Not working.
  132.  
  133. - Help:              Not working
  134.  
  135. [General Page]
  136.  
  137. - Disable logo:      allows to hide/display the startup logo.
  138.  
  139. - Subject length:    unchecking the "Default" button you'll be able
  140.                      to specify a non default lenght (the default is
  141.                      40 characters and the maximum is 255)
  142.  
  143. - Read only mode:    If this is checked you can read the attributes, but
  144.                      cannot modify them.
  145.  
  146. - Font:              The button doesn't work yet. Anyway, to set a new
  147.                      font just drag it on a free region of the main window
  148.                      or on the window border from the font palette.
  149.                  
  150. [Selection page]
  151.  
  152. - Extended file selection:     Allows to select multiple files.
  153.  
  154. - Select all files in directory:     If the program is opened by passing it
  155.                      a directory name as argument, if the "Extended selection"
  156.                      is enabled, all files contained in the directory will
  157.                      be selected.
  158.  
  159. - Single mouse click: Allows to select drive/directory/file with one mouse
  160.                      click rather than with a double click.
  161.  
  162. - Show file selection window: If checked the window is displayed in its
  163.                      its full size. When it is unchecked only the attributes
  164.                      of the current file are diaplayed.
  165.  
  166. - Only directory:    If the previous checkbox is enabled the window will
  167.                      be displayed in it full size only when the argument
  168.                      of the program is a directory.
  169.  
  170. [Import page 1 of 2]
  171.  
  172. The following options haven't yet been implemented.
  173.  
  174. -Enable:             If the file doesn't have .SUBJECT or .COMMNET EA,
  175.                      the program will automatically search for a file_id.diz,
  176.                      4DOS-4OS/2 description or other, as specified in
  177.                      Import page 2.
  178.  
  179. -View only:          If any description of the current file is found in 
  180.                      it will be showed in the "Subject" or "Comment" field
  181.                      of the main window but it will not be copied to the
  182.                      file EAs.
  183.  
  184. -(Import to) Subject: If any description is found it will displayed in the
  185.                      subject field and imported in the .SUBJECT EA if the
  186.                      "View only" option is unchecked. If the length of the
  187.                      imported text exceedes the defined Subject length it
  188.                      will be truncated.
  189.  
  190. -(Import to) Comment: As above, but the target of the import operation will
  191.                      be the Comments field or .COMMENT EA.
  192.  
  193. -(Import to) Auto select: The target of the imported operation will be the
  194.                      "Subject" field if the text is shorter than the
  195.                      defined subject length, otherwise the text will be
  196.                      imported to the "Comments" field.
  197.  
  198. [Import page 2 of 2]
  199.  
  200. The following options haven't yet been implemented.
  201.  
  202. (Default import mode) Allows to choose where to search first for the current
  203.                      file description:
  204.  
  205. -4 DOS - 4 OS/2      The program will search in a 4 DOS - 4 OS/2 description
  206.                      file in the current directory.
  207.  
  208. DESCRIPT.ION         Allows to specify the name of the 4 DOS - 4 OS/2
  209.                      description file.
  210.  
  211. -file_id.diz         Looks for a file_id.diz in the file if it is an
  212.                      archive of a known type.
  213.  
  214. -Enable user defined file  Looks for the description in a file defined by
  215.                      the user in the "File name" field.
  216.  
  217. -Other               Prompts the user for a file name from which to import.
  218.  
  219. -Run external program Allows to specify an external program in the "Program
  220.                      name" field for formatting or extracting the text to be
  221.                      imported.
  222.  
  223. [Report page]
  224.  
  225. The following options haven't yet been implemented.
  226.  
  227. -Auto report         Allows to generate a report with all file data and
  228.                      attributes. The report will be showed in a separate
  229.                      window. It will be possible to print it and save it
  230.                      to file. If this checkbox is selected, usually, both
  231.                      the main program window and the report window will
  232.                      be displayed. If this checkbox is unchecked it will
  233.                      always be possible to generate a Report by selecting
  234.                      the button in the toolbar of the main window or by
  235.                      selecting from the menu File->Report.
  236.  
  237. -Show only report    Only the report window will be showed.
  238.  
  239. -Only directory      The report will be generated only if the argument is
  240.                      a directory.
  241.  
  242. -Selected files      Only the selected files will be included in the report.
  243.  
  244. -All files           All files in the current directory will be included
  245.                      in the report.
  246.  
  247. -Full Tree           All files in the current directory and, recursively,
  248.                      in all its subdirectories will be included in the
  249.                      report
  250.  
  251.  
  252. Menu
  253. ====
  254. There are two pop-up menus. Clicking with mouse button 2 on the edit controls
  255. (Subject entryfield and Keys/Comments fields) you will get the most complete
  256. menu. The menu you'll get by clicking elsewhere will not have the Edit
  257. submenu.
  258.  
  259. Submenu File
  260. Select->Browse       Show/hide drive/directory/file selection window
  261. Select->Select all   Selects all files in the current directory
  262. Select->Deselect all Deselect all files
  263. Select->Mask         Allows to specify a selection mask (not yet implemented)
  264. Refresh              Refresh the contents of the drive/directory/file selection
  265.                      window.
  266. Save attributes      Saves the current attributes.
  267. Report               See Preferences: [Report page]
  268. Find                 Not yet implemented
  269. Exit                 Terminate the application.
  270.  
  271. Submenu Options
  272. General Preferences  See the Preferences section
  273. Font                  "   "       "         "
  274. Read only mode        "   "       "         "
  275.  
  276. Submenu Edit         not yet implemented
  277. Submenu Help         not yet implemented
  278.  
  279.  
  280. Known limitations
  281. =================
  282. -1) The inner controls will not be resized correctly if the maximized size
  283.     of the windows is limited by the "Warp Center" of OS/2 4.x.
  284. -2) I've used standard "list box" controls so there could be problems if
  285.     you have large amounts of files in your folders (32765 files with
  286.     OS/2 Warp 3 or 4 - I'm not sure about OS/2 2.x).
  287. -3) The code has not yet been optimized, neither for size not for speed.
  288.     The program works very well with my P100 machine, and I think the speed
  289.     could be acceptable even with a 386 (let me know if you have any problem).
  290.     It still does all work in a unique thread, so some operation like
  291.     modifying attributes of a alrge number of file, will not allow you to
  292.     interact with the system until the end of it.
  293.     The next release will be multithreaded.
  294.     The program has not been packed, but if you have warp 3 or 4 you could
  295.     shrink it up by LXLITE. (It is a free utility by Andrew Zabolotny.
  296.     You can download it from:
  297.     hobbes.nmsu.edu/pub/os2/util/archiver/lxlt118.zip).  
  298. -4) If multiple files are selected, selecting a new file (and deselecting
  299.     previously selected files) will display the "Save..." dialog. Clicking
  300.     on the "Save" button in this dialog will allow to save only the topmost
  301.     of the previously selected files. So in order to set the same attribute
  302.     for multiple files it is necessary to click on the save button in the
  303.     main window.
  304. -5) Since control size depends on the system default font size rather than
  305.     on the font used by the controls or by their owner window, the program
  306.     window could be too large with the default system font.
  307.     In a future release I'll add a routine to make all controls automatically
  308.     resize themselves according to the size of the font used in the window.
  309.  
  310.  
  311. What will be in the future releases?
  312. ====================================
  313. I will implement the still missing features as soon as possible.
  314. Besides that I'll add drag & drop capability and an "Attribute" menu
  315. item to every file object menu.
  316.  
  317. For any suggestion or bug report write to me:
  318.  
  319. Alessandro Cantatore - Team OS/2 Italy
  320. email:    alexcant@tin.it
  321.           alex.cant@iol.it
  322. fidonet:  2:335:705/2